home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / cfr_a84.zip / MANUAL.ESP < prev    next >
Text File  |  1996-08-28  |  14KB  |  279 lines
  1. ┌─────────────────────────────────────────────────────────────────────┐
  2. │ CFRoute 0.84 alpha - Empaquetador de netmail para DOS y OS/2        │
  3. │ Carlos Fernández Sanz, 2:341/70@fidonet.org, 93:341/110@subred.org  │
  4. │ Software gratuito                                                   │
  5. └─────────────────────────────────────────────────────────────────────┘
  6.  
  7. Esta versión es todavía una alpha. Por tanto doy por hecho que quien la
  8. use sabe manejar las cosas, por tanto no me extiendo.
  9.  
  10. Brevemente, CFRoute es un empaquetador de netmail para sistemas compa-
  11. tibles con Binkley, como Xenia o la versión 1.10 de MainDoor. El sis-
  12. tema Binkley es mucho más rápido que el dinámico de FrontDoor o Main-
  13. door (antes de la versión 1.10), y tiene la ventaja adicional de que
  14. permite ver los nets ya empaquetados con programas con InspectA o
  15. YABOM, sin tener que descomprimir un archivo de correo y buscar el
  16. .PKT que contiene el netmail.
  17. La mayoría de los tossers incluyen una opción de empaquetar para
  18. Binkley. Por ejemplo en FastEcho, el parámetro es pack -p. Lamentable-
  19. mente no está demasiado bien implementado y no permite por ejemplo
  20. rutar ficheros.
  21.  
  22. Características generales de CFRoute
  23. ------------------------------------
  24.     - Permite definir el sistema al que se mandan los mensajes tanto
  25.       por el destino como el origen.
  26.     - Permite (bueno, permitirá - aun no está terminado del todo)
  27.       definir destinos diferentes para netmails encriptados y no
  28.       encriptados.
  29.     - Permite definir diferentes atributos para los nets según el
  30.       destino y el origen, y no sólo el sistema de rutado.
  31.     - Intérprete de configuración extremadamente flexible.
  32.     - Limitado sólo por la memoria libre. No hay ningún límite pre-
  33.       fijado ni en número de rutas ni en número de sistemas por
  34.       ruta, ni de direcciones, ni de ninguna otra cosa.
  35.     - Permite definir rutas diferentes para nets con attach y sin
  36.       attach.
  37.     - Genera paquetes tipo 2 (FTS-001) y 2+ (FSC-0039).
  38.     - Permitirá definir rutados alternativos según el día de la
  39.       semana.
  40.     - Comodines ?, # y *.
  41.     - Gratuito.
  42.     - Fuentes en C++ disponibles (cuando esté terminado).
  43.  
  44. Llamando a CFRoute
  45. ------------------
  46. CFRoute acepta pocos parámetros. Los que no empiezan por / o
  47. - se consideran nombres de ficheros de configuración. Normalmente
  48. sólo se usa uno (por ejemplo el mío es ROUTE.CFR) y si se usan
  49. más se llaman desde el principal, pero no es imprescindible. Puedes
  50. leer más desde la línea de comandos, por ejemplo CFROUTE 1.CFR 2.CFR
  51. es válido.
  52. De momento sólo hay dos parámetros:
  53.        -?  Saca una pequeña pantalla de ayuda.
  54.        -I  Ignora la fecha de los mensajes. Por defecto, CFRoute
  55.            se acuerda de la última vez que se usó y no procesa los
  56.            .MSG anteriores, con lo que se gana mucha velocidad.
  57.            Sin embargo algunos programas crean .MSG con una fecha
  58.            incorrecta (no la de creación del .MSG sino otra anterior,
  59.            por ejemplo NetMgr al hacer copia de mensajes con Action
  60.            FORWARD) y CFRroute no los procesaría si no se usase
  61.            este parámetro.
  62.  
  63. Configuración
  64. -------------
  65. El nombre del fichero de configuración es libre. CFRoute se carga
  66. con el nombre del fichero como único paramétro. Por ejemplo, yo
  67. uso CFR-OS2 ROUTE.CFR para ejecutarlo.
  68. Lo primero que hay que decir es que para CFROUTE todo lo que no
  69. sea una orden es un parámetro de la orden anterior, independien-
  70. temente de la línea en que se encuentre. Por tanto los saltos
  71. de línea no determinan en absoluto el funcionamiento. Es posible
  72. poner toda la configuración en una línea, o poner el parámetro
  73. de una orden en la línea siguiente. Se admiten espacios entre
  74. órdenes/parámetros y también tabuladores, sin excepciones.
  75. Como en casi todos los programas, una línea que empieza por
  76. punto y coma se entiende como comentario y se ignora. Excepción:
  77. Líneas que empiezan por ;CFR. Estas líneas serán procesadas por
  78. CFRoute, pero no por los demás programas que interpretan el
  79. ; como comentario. De esta forma, se puede compartir el fichero
  80. de configuración con otros programas simplemente precediendo las
  81. líneas específicas de CFRoute con ;CFR.
  82. Las órdenes que soporta son las siguientes:
  83.  
  84. - LOG nombre_del_log
  85.   El log es bastante extenso. Graba toda la cabecera el mensaje,
  86.   además del sistema a que se manda, naturalmente. También se
  87.   graba la antigüedad en días del mensaje, y su tamaño en bytes.
  88.   Esta orden es obligatoria.
  89. - NETMAIL directorio_de_netmail
  90.   También obligatoria.
  91. - OUTBOUND directorio_principal_de_salida.
  92.   Es el directorio principal de outbound, y logicamente tiene
  93.   que ser el mismo que en el mailer.
  94. - MAIN dirección
  95.   La dirección principal del sistema. Debe ser una dirección 5D
  96.   completa. Se usa como dirección por defecto, y para completar
  97.   las direcciones en que sea necesario. El dominio sólo se uti-
  98.   za para el nombre de los directorios de outbound. Ejemplo:
  99.   2:341/70@fidonet.
  100. - AKA dirección [dirección...]
  101.   Dirección o direcciones adicionales del sistema. No necesa-
  102.   riamente tienen que ser 5D, usándose la dirección principal
  103.   si fuera necesario. Por ejemplo, AKA 62 79 añade como direc-
  104.   ciones 2:341/62@fidonet y 2:341/79@fidonet en caso de haber
  105.   defido como principal la del ejemplo anterior.
  106. - PACKET2 direcciones
  107.   Define una lista de sistemas (las direcciones aceptan como-
  108.   dines y excepciones, de la forma indicada más abajo) para
  109.   los que no se generan paquetes 2+ sino 2 (es decir, FTS-
  110.   001). Los paquetes 2+ simplemente usan una zona reserva-
  111.   da de los tipo 2 (son 20 bytes que en este tipo están a 0)
  112.   y no creo que haya ningún software que soporte 2 y no 2+,
  113.   pero por si acaso, la opción está disponible.
  114. - PASSWORD clave dirección <dirección...>
  115.   Define la clave que se va a utilizar en los PKT para los
  116.   sistemas indicados a continuación. Por ejemplo:
  117.       PASSWORD EJEMPLO 2:348/201 2:348/202 2:34/0
  118. - INCLUDE fichero
  119.   Lee un fichero como parte de la configuración. Se pueden
  120.   anidar las llamadas.
  121.  
  122. Rutado
  123. ------
  124. Después de las anteriores órdenes, se define el rutado. El
  125. sistema es casi idéntico al utilizado en el route.fe de
  126. fastecho, por lo que los que lo useis podeis copiar y pegar.
  127. Por defecto, los netmails *NO SE TOCAN*. Si CFRoute no sabe
  128. a donde mandar un net, porque no cumple ninguna de las con-
  129. diciones indicadas en el rutado, se queda en el directorio
  130. de netmail.
  131. Por defecto, CFRoute da más importancia a la ULTIMA línea
  132. route-to que cumple las condiciones del netmail que se
  133. está procesando (o sea, igual que FE).
  134. Hay tres órdenes de rutado, cada una con tres variantes. Todas
  135. se pueden escribir con o sin guiones.
  136.  
  137.     ROUTE-TO, ROUTE-MAIL, y ROUTE-FILES
  138.     -----------------------------------
  139.     Funcionan igual que el route-to de fastecho, con la excep-
  140.     ción de que route-to afecta a todos los netmails, route-
  141.     mail afecta a los netmails sin attach y route-files afec-
  142.     ta a los netmails con attach.
  143.     Los parámetros pueden ser:
  144.             - Direcciones. La primera es siempre el sistema
  145.               a donde se dirigen los nets, y las siguientes
  146.               los sistemas *de destino* para los que el vá-
  147.               lido la orden. Exceptuando la primera direc-
  148.               ción, las demás admiten comodines. Estos pue-
  149.               den ser
  150.                     ? -> Un carácter o ninguno. Por ejemplo
  151.                          2:34? significa 2:34 y también
  152.                          2:340,2:341, etc.
  153.                     # -> Un carácter pero no ninguno. Es
  154.                          decir 2:34# significa 2:340,
  155.                          2:341, etc, pero no 2:34.
  156.                     * -> Ningún carácter o más. Ejemplo:
  157.                          2:34* = 2:34, 2:341, 2:3411...
  158.             - Un atributo, que puede ser NORMAL, CRASH,
  159.               HOLD o DIR (por direct), que indica la
  160.               prioridad del PKT resultante. Si no se indica
  161.               ninguno, se usa NORMAL.
  162.             - FROM, para indicar que las siguientes direc-
  163.               ciones son de origen y no de destino.
  164.             - EXCEPT, para indicar excepciones.
  165.             - Una lista de días de la semana para los que la
  166.               orden tiene validez. Pueden ser M (lunes),
  167.               T (martes), W (miércoles), H (jueves), F (viernes),
  168.               S (sábado) y U (domingo).
  169.             - ENC o NONENC, para indicar que el rutado se
  170.               refiere exclusivamente a netmails encriptados
  171.               o no encriptados.
  172.     Ejemplos:
  173.         1.
  174.             - ROUTE-TO 2:348/201 CRASH 2:34/0
  175.             - ROUTE-TO 2:348/201 1:* 2:* 3:* 4:* 5:* 6:*
  176.               Esto le manda crash a Manuel Fuentes los nets
  177.               dirigidos a su dirección de RC, mientras que
  178.               los demás se los pone normales.
  179.               Fijaos que el atributo puede ir en cualquier
  180.               lugar dentro de la orden. Es decir,
  181.               ROUTE-TO CRASH 2:348/201 2:34/0 y
  182.               ROUTE-TO 2:348/201 2:34/0 CRASH
  183.               serían iguales.
  184.          2. - ROUTE-TO 2:348/201 CRASH 2:34/0 FROM 2:34*/0
  185.               Le manda a Manolo crash todos los nets diri-
  186.               gidos a su dirección administrativa, y man-
  187.               dados por NCs exclusivamente.
  188.          3. - ROUTE-TO 1:270/101 1:* FROM 2:341/*
  189.               Manda todos los nets para la zona 1 escritos
  190.               por gente de la 341 a través de George Peace,
  191.               mientras que los provinientes de otras
  192.               nets seguirían el rutado por defecto, de
  193.               haberlo.
  194.          4. - ROUTE-TO 2:348/201 FROM 1:*
  195.               (No es que el ejemplo tenga sentido real). Le
  196.               manda a Manolo todos los nets que vengan de
  197.               la zona 1, independientemente de su destino.
  198.          5. - ROUTE-TO 2:348/201 2:* EXCEPT 2:34/* EXCEPT 2:348/*
  199.               Le manda a Manolo todos los nets para la zona
  200.               2, excepto los dirigidos a la región R34 ex-
  201.               cepto los dirigidos a Galicia. Como se ve,
  202.               un EXCEPT actúa sobre el anterior y el resul-
  203.               tado es que se mandan todos los nets para
  204.               Europa excepto España, más los de Galicia, al
  205.               sistema de Manolo.
  206.          6. - ROUTE-TO 2:348/201 2:* EXCEPT FROM 2:341/*
  207.               Le manda a Manolo todos los nets para la zona
  208.               2, excepto los escritos por la 341.
  209.          7. - ROUTE-TO 2:2/0 HF 2:29*
  210.               Le manda al ZC/2 el correo para su región los
  211.               jueves y los viernes (para aprovechar la lla-
  212.               mada para recoger la nodediff). Los demás
  213.               días se usa el rutado por defecto, si lo hay.
  214.          8. - ROUTE-TO 93:7000/0 NONENC 93:7000/0
  215.               Manda al gateway de SubNet->InterNet todos los
  216.               nets para InterNet, siempre que no vayan
  217.               encriptados (no está en uso :-)).
  218.  
  219.     Creo que cogeis la idea :-) En lugar de route-to se puede
  220.     usar route-mail o route-files para discriminar por el
  221.     atributo de attach. Por lo demás la sintaxis es la misma.
  222.     Tened en cuenta que los atributos del .MSG mandan sobre
  223.     lo indicado aquí. Por ejemplo, un mensaje con el atribu-
  224.     to crash se pondrá crash para el destino directamente,
  225.     independientemente del rutado.
  226.     Hay dos atributos que cambian la dirección de rutado.
  227.     ZON hace que el netmail deba ir hacia el zonagate. Por
  228.     ejemplo
  229.         ROUTE-TO 1:270/101 1:*
  230.         ROUTE-TO 2:348/202 2:* 3:* 4:* 5:* 6:* 7:*
  231.     Un netmail hacia la zona 1 que NO lleve el flag de
  232.     zonegate se manda a 1:270/101. Sin embargo un net
  233.     dirigido a la zona 1 con el flag ZON se manda a
  234.     Manolo, puesto que debe rutarse vía 2:1/0 que es
  235.     el zonegate.
  236.     HUB hace que el net se dirija al /0, lo que general-
  237.     mente no afecta para nada salvo que sea para la mis-
  238.     ma net en que nos encontramos, en cuyo caso se ig-
  239.     nora el flag y se ruta normalmente.
  240.  
  241.     DIRECT (o DIRECT-TO), DIRECT-MAIL y DIRECT-FILES
  242.     ------------------------------------------------
  243.     Igual que ROUTE-*, sólo que no hay dirección de rutado
  244.     puesto que todos los nets se empaquetan directamente
  245.     a su destino. También se pueden indicar direcciones de
  246.     origen, excepciones y atributos.
  247.  
  248.     ROUTE-BOSS, ROUTE-BOSS-MAIL y ROUTE-BOSS-FILES
  249.     ----------------------------------------------
  250.     También NO-ROUTE, NO-ROUTE-MAIL y NO-ROUTE-FILES. Sig-
  251.     nifica que los nets se dejan directos para los NODOS
  252.     de destino, por tanto un net para 2:341/14.23 se deja
  253.     directo para 2:341/14.0, es decir, el boss. FastEcho
  254.     llama a esta orden NO-ROUTE, aunque me parece un poco
  255.     confuso ya que parece que el netmail no se ruta, y
  256.     realmente algo de rutado hay siempre que no va a su
  257.     destino, aunque este sea un punto.
  258.  
  259.     TOPDOWN
  260.     -------
  261.     Hace que la línea más importante sea la primera que
  262.     cumpla la condición del net, en lugar de la última.
  263.  
  264.     Macros
  265.     ------
  266.     MYZONES, MYNETS y MYPOINTS. Se expanden respectiva-
  267.     mente a todas nuestras zonas (al contrario que en
  268.     fastecho que es MYZONE y equivale sólo a la zona
  269.     principal), todas nuestras nets, y todos nuestros
  270.     puntos. Pueden utilizarse en lugar de cualquier
  271.     dirección que admita comodines.
  272.  
  273. Como comentario final, me gustaría que evitaseis distri-
  274. buir esta versión. No está terminada, y aunque la he
  275. probado bastante, podría tener bugs, aparte de que le
  276. faltan algunas cosas que quiero añadir antes de hacer
  277. público el programa.
  278.  
  279.